Carbon


InsTime

Header: Timer.h Carbon status: Modified

Installs a task structure into the Time Manager task queue.

void InsTime (
    QElemPtr tmTaskPtr
);
Parameter descriptions
tmTaskPtr

A pointer to an original task structure to be installed in the queue.

DISCUSSION

The InsTime function adds the Time Manager task structure specified by tmTaskPtr to the Time Manager queue. Your application should fill in the tmAddr field of the task structure and should set the tmCount field to 0. The tmTaskPtr parameter must point to an original Time Manager task structure.

With the revised and extended Time Managers, you can set tmAddr to NULL if you do not want a task to execute when the delay passed to PrimeTime expires. Also, the revised Time Manager resets the high-order bit of the qType field to 0 when you call InsTime.

AVAILABILITY

Modified in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

CARBON NOTES

The interface for Time Manager callbacks will change, because the task record is currently available only from 68k code.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)